std::unordered_map::insert

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Containers library
array (C++11) vector deque forward_list (C++11) list set multiset map multimap unordered_set (C++11) unordered_multiset (C++11) unordered_map (C++11) unordered_multimap (C++11) stack queue priority_queue
std::unordered_map
Member functions unordered_map::unordered_map unordered_map::~unordered_map unordered_map::operator= unordered_map::get_allocator Iterators unordered_map::begin unordered_map::cbegin unordered_map::end unordered_map::cend Capacity unordered_map::erase unordered_map::size unordered_map::max_size Modifiers unordered_map::clear unordered_map::insert unordered_map::emplace unordered_map::emplace_hint unordered_map::erase unordered_map::swap Lookup unordered_map::count unordered_map::find unordered_map::equal_range Bucket interface unordered_map::begin(int) unordered_map::end(int) unordered_map::bucket_count unordered_map::max_bucket_count unordered_map::bucket_size unordered_map::bucket Hash policy unordered_map::load_factor unordered_map::max_load_factor unordered_map::rehash unordered_map::reserve Observers unordered_map::hash_function unordered_map::key_eq

std::pair<iterator,bool> insert( const value_type& value );	(1)	(C++11 feature)
template <class P> std::pair<iterator, bool> insert( P&& value );	(2)	(C++11 feature)
iterator insert( const_iterator hint, const value_type& value );	(3)	(C++11 feature)
template <class P> iterator insert( const_iterator hint, P&& value );	(4)	(C++11 feature)
template <class InputIterator> void insert( InputIterator first, InputIterator last );	(5)	(C++11 feature)
void insert( std::initializer_list<value_type> ilist );	(6)	(C++11 feature)

Inserts elements to the container.

1-2) inserts value.

3-4) inserts value, using hint as a suggestion where the element should go.

5) inserts elements from range [first, last).

6) inserts elements from initializer list ilist.

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

[edit] Parameters

hint	-	iterator, used as a suggestion as to where to insert the content
value	-	element value to insert
first, last	-	range of elements to insert
ilist	-	initializer list to insert the values from

[edit] Return value

1-2) returns a pair consisting of a bool denoting whether the insertion took place and an iterator to the inserted element.

3-4) returns an iterator to the inserted element or to the element, that prevented the insertion.

5-6) none.

[edit] Complexity

This section is incomplete

[edit] See also

emplace	constructs element in-place (public member function)
emplace_hint	constructs elements in-place using a hint (public member function)